@aws-cdk/aws-sns

AWS SNS Construct Library

Add an SNS Topic to your stack:

import sns = require('@aws-cdk/aws-sns');

const topic = new sns.Topic(this, 'Topic', {
    displayName: 'Customer subscription topic'
});

Subscriptions

Various subscriptions can be added to the topic by calling the .subscribeXxx() methods on the topic.

Add an HTTPS Subscription to your topic:

const myTopic = new sns.Topic(this, 'MyTopic');

myTopic.subscribeUrl('MyHttpsSubscription', 'https://foobar.com/');

Subscribe a queue to the topic:

Example of subscribing a queue to a topic

Note that subscriptions of queues in different accounts need to be manually confirmed by reading the initial message from the queue and visiting the link found in it.

CloudWatch Event Rule Target

SNS topics can be used as targets for CloudWatch event rules.

Use the @aws-cdk/aws-events-targets.SnsTopicTarget:

import targets = require('@aws-cdk/aws-events-targets');

codeCommitRepository.onCommit(new targets.SnsTopicTarget(myTopic));

This will result in adding a target to the event rule and will also modify the topic resource policy to allow CloudWatch events to publish to the topic.

Changelog

0.33.0 (2019-05-30)

IMPORTANT: apps created with the CDK version 0.33.0 and above cannot be used with an older CLI version.

Bug Fixes

• core: Fn.cidr should return a list and not a string (#2678) (9d2ea2a), closes #2671
• cli: fix ts-node usage on Windows (#2660) (5fe0af5)
• cli: make cdk docs open the new API reference (#2633) (6450758)
• cli: correctly pass build args to docker build (#2634) (9c58d6f)
• core: hide dependencyRoots from public API (#2668) (2ba5ad2), closes #2348
• autoscaling: move lifecycle hook targets to their own module (#2628) (b282132), closes #2447
• codepipeline: no longer allow providing an index when adding a Stage to a Pipeline. (#2624) (ce39b12)
• codepipeline-actions: correctly serialize the userParameters passed to the Lambda invoke Action. (#2537) (ceaf54a)
• cx-api: improve compatibility messages for cli <=> app (#2676) (38a9894)
• ecs: move high level ECS constructs into aws-ecs-patterns (#2623) (f901313)
• logs: move log destinations into 'aws-logs-destinations' (#2655) (01601c2), closes #2444
• s3: move notification destinations into their own module (#2659) (185951c), closes #2445

Features

• cli: decouple "synth" and "deploy" through cloud assemblies (#2636) (c52bcfc), closes #1893 #2093 #1954 #2310 #2073 #1245 #341 #956 #233 #2016
• acm: allow specifying region for validated certificates (#2626) (1a7d4db)
• apigateway: support for UsagePlan, ApiKey, UsagePlanKey (#2564) (203f114), closes #723
• autoscaling: allow setting spotPrice (#2571) (d640055), closes #2208
• cfn: update CloudFormation spec to v3.3.0 (#2669) (0f553ee)
• cli: disable noUnusedLocals and noUnusedParameters from typescript templates (#2654) (b061826)
• cloudformation: aws-api custom resource (#1850) (9a48b66)
• cloudwatch: support all Y-Axis properties (#2406) (8904c3e), closes #2385

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• logs: using a Lambda or Kinesis Stream as CloudWatch log subscription destination now requires an integration object from the @aws-cdk/aws-logs-destinations package.
• codepipeline-actions: removed the addPutJobResultPolicy property when creating LambdaInvokeAction.
• cli: --interactive has been removed
• cli: --numbered has been removed
• cli: --staging is now a boolean flag that indicates whether assets should be copied to the --output directory or directly referenced (--no-staging is useful for e.g. local debugging with SAM CLI)
• assets: Assets (e.g. Lambda code assets) are now referenced relative to the output directory.
• assert: SynthUtils.templateForStackName has been removed (use SynthUtils.synthesize(stack).template).
• cx-api: cxapi.SynthesizedStack renamed to cxapi.CloudFormationStackArtifact with multiple API changes.
• core: cdk.App.run() now returns a cxapi.CloudAssembly instead of cdk.ISynthesisSession.
• s3: using a Topic, Queue or Lambda as bucket notification destination now requires an integration object from the @aws-cdk/aws-s3-notifications package.
• autoscaling: using a Topic, Queue or Lambda as Lifecycle Hook Target now requires an integration object from the @aws-cdk/aws-autoscaling-hooktargets package.
• codepipeline: the property atIndex has been removed from the StagePlacement interface.
• aws-ecs: These changes move all L3 and higher constructs out of the aws-ecs module into the aws-ecs-patterns module. The following constructs have been moved into the aws-ecs-patterns module: EcsQueueWorkerService, FargateQueueWorkerService, LoadBalancedEcsService, LoadBalancedFargateService and LoadBalancedFargateServiceApplets.
• cloudwatch: rename leftAxisRange => leftYAxis, rightAxisRange => rightYAxis, rename YAxisRange => YAxisProps.